home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Programming / COP / COP.readme < prev    next >
Encoding:
Text File  |  2001-03-27  |  15.6 KB  |  379 lines
  1. Short:    Low Level Debugger
  2. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     dev/debug
  5. Version:  1.85
  6. Requires: An Amiga or even better two. The OS version doesn't matter.
  7.  
  8. *****************************************************************************
  9. **                                                                         **
  10. ** ___________                                                             **
  11. ** \        */                                                             **
  12. **  /-----------     #######     #######    ########                       **
  13. **  |    ^ |        ##      ##  ##     ##   ##     ##                      **
  14. **  |      _\       ##          ##     ##   ##     ##  Version 1.85        **
  15. **  |      |        ##          ##     ##   ########                       **
  16. **  |    --|        ##          ##     ##   ##                             **
  17. **  +-----/         ##      ##  ##     ##   ##                             **
  18. **   |   |           #######     #######    ## (c) 1993-2001 THOR-Software **
  19. **                                                                         **
  20. **                                                                         **
  21. **              A Low Level Debugger for all Amiga Systems                 **
  22. **                                                                         **
  23. *****************************************************************************
  24.  
  25.                                     by
  26.  
  27.      _______         _____  _____           __     _
  28.         /    /    / /    / /    /         \/_/    //_/_
  29.        /    /____/ /    / /____/   ___    /  ____// /        _      __
  30.       /    /    / /    / /   \           /  /|/ /  /  /   /_/ / /\_/_/
  31.      /    /    / /____/ /    /         _/__/_/ /__/|_/_/_/ /_/_/  /_
  32.                                               /                   
  33.  
  34. _____________________________________________________________________________
  35.  
  36.             About COP
  37.  
  38. COP is a low level debugger for all amiga systems. "Low Level" means it
  39. directly plays with the hardware, does not have GUI, but is unbeatable
  40. stable. Its main purpose is to debug programs not debugable with the usual
  41. "source level" debugger, like hardware device drivers, DOS handlers in action
  42. and much more. It supports debugging by the serial port, thru a standard
  43. tty terminal (also a COP type 5 terminal is better. A terminal program
  44. for amigas is included), and a build-in terminal emulation in case no 
  45. second computer is available.
  46.  
  47. In case you want to use COP, make sure:
  48.  
  49. -that you really want it. COP is not easy to use!
  50. -that you know assembly language. It won't work without!
  51. -that you have a lot of good will!
  52.  
  53.  
  54. EMail:  thor@einstein.math.tu-berlin.de
  55.  
  56. WWW:    http://www.math.tu-berlin.de/~thor/thor/index.html
  57.  
  58.  
  59. By the way: You should read the documentation first (before trying to get
  60. COP running)!
  61.  
  62. This is even more important if you own a '060 or '040 system. Special hints
  63. can be found at the end of the COP.doc file.
  64.  
  65. _____________________________________________________________________________
  66.  
  67. Changes made in 1.85:    
  68.  
  69. - Fixed several 060 related bugs:
  70.     - an unnecessary "fnop" trashed the fpiar register and hence
  71.       made it impossible to debug floating point exception handlers.
  72.     - the bootstrap code of various boards let exec identify the
  73.       68060 as 68010 and hence trashed the CPU check of the resident
  74.       code of COP. COP runs now the CPU test itself.
  75.     - since the 68060.library has to replace AddTask(), COPs 
  76.       AddTask() patch was overwritten in case it was made resident
  77.       before. "RestoreVBR" will now re-install the patch to make
  78.       sure the proper exception handler is called on a crash. This
  79.       is a bit touchy and requires the creation of a temporary
  80.       task.
  81.  
  82. _____________________________________________________________________________
  83.  
  84. Changes made in 1.83:    
  85.  
  86. - Fixed the fmovem <dynamic register list> disassembly.
  87. - Fixed incorrect FPU exception handling for the 040 and the 060.
  88. - Fixed a spurious Bus error which occured on some 040 systems at times
  89.   the MMU wasn't active (Early bootup)
  90. - Fixed many bugs in the "Terminal" program: 
  91.     - Hangs on menu pop-open are history, I hope. (Semaphore deadlocks)
  92.     - ATR transfer became more stable (but still leaves a lot to be 
  93.       desired)
  94.     - ATR "autodetection" mode has been added.
  95. _____________________________________________________________________________
  96.  
  97. Changes made in 1.82:
  98.  
  99. - Fixed the (d.32,PC) EA disassembly which was wrong by two bytes.
  100. - Added the comment character ";" to the command interpreter.
  101. _____________________________________________________________________________
  102.  
  103. Changes made in 1.81:
  104.  
  105. - Added some workarounds in the terminal driver against a 68030 firmware bug.
  106. - Fixed the "find.i" command which was broken.
  107. - Fixed printer support. In case of printer trouble, it did not disable
  108. printing correctly.
  109. - The long mulitplication and division opcodes are now correctly disassembled
  110. as "extended".
  111. - Fixed a bug in the setup logic which caused the program to report that
  112. interrupts have been overwritten on plain 68000 systems.  
  113. _____________________________________________________________________________
  114.  
  115. Changes made in 1.80:
  116.  
  117. - COP disables now the caches if the MMU is disabled. This helps preventing
  118. some cache related problems on boards with Z-II memory which might not allow
  119. burst accesses.
  120. - COP autodetects now a 68060 CPU even if the correspoding 060 flag in 
  121. ExecBase->AttnFlags is not set correctly. The SET060 option is no longer
  122. required to correct this manually.
  123. - Fixed a bug in the disassembler, did not disassemble 64 bit arithmetics
  124. correctly.
  125. - Updated the MuForce compatibility hints slightly. Mainly, specify
  126. NOGURUPATCH and avoid CAPTURESUPER.
  127.  
  128. _____________________________________________________________________________
  129.  
  130. Changes made in 1.79:
  131.  
  132. - Fixed the terminal program a lot. The I/O mechanism was very unstable.
  133. - Updated the ATerm download protocol.
  134. - Partially fixed '060 support of the 1.77 release. This might be still
  135.   broken, but there's currently nothing I can do about it.
  136. - Rewrote the vector setup logic and the autovector monitor.
  137. - Updated the disassembler: tst.l ax was disassembled as illegal 
  138.   instead of extended.
  139. - Disassembler is now really MMU aware, removed an old cludge.
  140. _____________________________________________________________________________
  141.  
  142. Changes made in 1.77:
  143.  
  144. - Rewrote the IRQ table setup for MC68010 or better. It used to be a mess.
  145. - Fixed the cache control commands for the 68040 and 68060.
  146. - Added SegTracker support for stack traceback.
  147. - Fixed memory manager MMU support. It used to use the SRP instead of the
  148.   URP for checking table accesses and therefore caused problems with
  149.   MuGuardianAngel.
  150.  
  151. This release seems still to have problems on some 030 machines if it is 
  152. installed with SetCPU FASTROM active. I don't know why as I can't reproduce
  153. it on my 030 A2000. MuFastROM is recommended anyways.
  154. _____________________________________________________________________________
  155.  
  156. Changes made in 1.76:
  157.  
  158. - Internal release, unpublished.
  159.  
  160. _____________________________________________________________________________
  161.  
  162. Changes made in 1.75:
  163.  
  164. - Modified the exception handler routines a bit, they no longer block
  165.   interrupts completely.
  166. - Added the DARKEN command line option to blank the screen.
  167. - Fixed the memory list scan that failed with remapped low-memory areas.
  168. _____________________________________________________________________________
  169.  
  170. Changes made in 1.73:
  171.  
  172. - The "restorevbr" option did not work correctly and could cause problems
  173.   on 040 and 060 based machines.
  174. - The MMU could have been disabled on startup, forgot to saveback a 
  175.   register.
  176. - 030 bus error processing can now handle MuForce instruction emulation
  177.   in the zero-page.
  178.  
  179. _____________________________________________________________________________
  180.  
  181. Changes made in 1.72:
  182.  
  183. - Fixed a stupid bug in the 060 support code. COP did not test correctly
  184.   whether a memory address is really available due to a broken MMU table
  185.   scanner.
  186. _____________________________________________________________________________
  187.  
  188. Changes made in 1.71:
  189.  
  190. - The 1.69 version disabled the MMU on 030 systems completely. Fixed.
  191. - COP can now be made resident even on systems without autoconfig fast
  192.   memory.
  193. - The COP initializer was a bit too picky about the FPU bits and therefore
  194.   refused to keep resident on 040 and 060 systems.
  195. - Fixed 040 FPU related bugs.
  196. - Partial RTG support implemented, yeah!
  197.  
  198. _____________________________________________________________________________
  199.  
  200.  
  201. Changes made in 1.69:
  202.  
  203. - Fixed the disassembly of some 040 specific instructions, cpushp and others.
  204. - Fixed the startup code.
  205. - Fixed the documentation, COP was never Enforcer compatible when run on
  206.   a 040 and 060, unfortunately. It is compatible to "MuForce", which does
  207.   the same.
  208. - The bus error handler tries now to complete missing writebacks of the 040
  209.   processor.
  210.  
  211. _____________________________________________________________________________
  212.  
  213. Changes made in 1.68:
  214.  
  215. - Added 040 and 060 FPU instructions for single and double precision in the
  216.   disassembler.
  217. - Added PLPAR/W instructions.
  218. - Overflow handling in the expression evaluation was buggy.
  219. - MMU table lookup for 68060 was buggy, worked only for complete 4K tables.
  220. - MMU management included, the MMU registers are now written back.
  221.   (Let's hope this works for the 040 and 060, I haven't tested this)
  222. - The MMU URP/SRP registers can now be set by the user. However, be careful
  223.   with it, this may easely trash the system.
  224. - FPU emulator traps haven't been filtered out for the 040.
  225. _____________________________________________________________________________
  226.  
  227. Changes made in 1.67:
  228.  
  229. - Due to a silly mistake, the Enforcer was disabled completely for the
  230.   68030 processor.... Argh!
  231.  
  232. _____________________________________________________________________________
  233.  
  234. Changes made in 1.66:
  235.  
  236. - Fixed a horror bug in the MMU control section. After disabling the MMU,
  237.   I forgot to flush the ATC and the cache of the 68030. Since the cache
  238.   of the '020 and the '030 is BEHIND the MMU, it could still contain
  239.   addresses marked as INVALID and might create an enforcer hit on some
  240.   systems. This happens most likely in systems with the supervisor stack
  241.   in chip ram. Fixed.
  242. - General cleanup of the vector base register installation routine.
  243. - Included the SSPToFast program which *should* be run in the startup 
  244.   sequence for systems without autoconfig fast ram. Moving the SSP to
  245.   fast ram will increase the performance of the system.
  246.  
  247.  
  248. This release is mainly to due to Jörg Riemer. Thanks for letting me debug
  249. COP on his A1200, and thanks for the hospitality.
  250.  
  251.  
  252. Changes made in 1.65:
  253.  
  254. - Fixed a bug in the 68851 detection routine. This thing is now getting
  255.   "metamagical", too. As the rest of the kernal code...
  256.   Thanks, Dennis, for letting me know.
  257. - COP RESTOREVBR restores now, too ,the Alert entry that might have been
  258.   reset by the Enforcer.
  259. - Removed a bug from the symbol hunk parser that didn't respect HUNK_DEBUGs
  260.   as it should.
  261. _____________________________________________________________________________
  262.  
  263. Changes made in 1.64:
  264.  
  265. - Fixed another set of bugs in the disassembler. The "pmove bad/bac" opcoded
  266.   did not work.
  267. - The disassembler knows now the "fnop" command.
  268. - The register saveback routine was faulty for the '020 - it tried to save
  269.   the non-existing tt0,tt1 registers.
  270. _____________________________________________________________________________
  271.  
  272. Changes made in 1.63:
  273.  
  274. - Fixed a bug in the disassembler. The 0x7100 opcode was not detected as
  275.   illegal.
  276. - Fixed memory addressing bugs in the disassembler. Did not check for
  277.   validity of addresses. 
  278. - Fixed an addressing bug in the label manager. Did not check whether an
  279.   address is valid or not.
  280. - COP does no longer run the ROM code for the '060 in case no Enforcer/060
  281.   library is installed.
  282. - Added support code for the 68851 PMMU coprocessor. Should be detected
  283.   correctly now.
  284. _____________________________________________________________________________
  285.  
  286. Changes made in 1.62:
  287.  
  288. - Neither the NOMMU nor the NOEMU command line options worked in 1.61.
  289.   Sigh.
  290. - Added MMU and EMU keywords for symmetry.
  291. - Fixed just another bug in the '060 support code, thanks to Mark for
  292.   the hints and the testing. (I guess we're at 4% now).
  293. - Added the MMU support for MOVE, FIND and FILL commands.
  294. - Improved FIND command, displays the found instructions or bytes.
  295. - Made RESTOREVBR a bit smarter.
  296. - Updated the included DDT file to contain '060 specific gurus. Thanks, 
  297.   Mark!
  298. ____________________________________________________________________________
  299.  
  300. Changes made in 1.61:
  301.  
  302. - Fixed a lot of bugs in the '060 support code. Thus, the chance that
  303.   this release operates properly on a '060 has about doubled (from 1% to
  304.   2%, to be precise...).
  305. - Added NOEMU command line switch to bypass emulator traps.
  306. - Added proper support for the '060 '040 MMU and cache.
  307. - Debugged the AbsExecBase move.l emulator for the '060. Might actually work
  308.   by now, but is untested.
  309. - Changed some details in MMU handling.
  310. - Changed minor details for COP capturing its own bugs.
  311. - Added another function to the label manager, showing the label given an
  312.   address - LABL.F command.
  313. - Fixed a bug in the memory manager that did not handle non-writable memory
  314.   in the correct way.
  315. - Fixed a bug in the set-breakpoint logic.
  316. - Enhanced the stack traceback with the new label manager. It tries to find
  317.   out the label names.
  318. _____________________________________________________________________________
  319.  
  320. Changes made in 1.60:
  321.  
  322. - Removed bugs in the breakpoint logic.
  323. - Added SegTracker support for the REGS.G and (new) SEGM commands.
  324. - Updated MMU/Enforcer support since I finally bought a real 68030.
  325. - Added the NOMMU command line switch to disable the MMU bypass.
  326. - Added the ability to pre-compile the DDT files for faster parsing
  327.   with the "PRE" command line option.
  328. - Updated the Terminal program a bit.
  329. _____________________________________________________________________________
  330.  
  331. Changes made in 1.59:
  332.  
  333. - Removed a bug in the expression evaluator that made the indirection 
  334.   operator [] unuseable.
  335. - Removed a bug in the conditional break points.
  336. - Rewrote parts of the system segment.
  337. - Added support for the CyberGuard. That's not yet tested, however!
  338. - Added more '040 instructions I forgot.
  339. - Fixed a bug in the disassembler.
  340. - The previous fix of the "NODE" command broke it even more, fixed!
  341. - Fixed plain MC68000 support that was broken since 1.56.
  342. _____________________________________________________________________________
  343.  
  344. Changes made in 1.58:
  345.  
  346. -Added two '040 instructions I wasn't aware of.
  347. -Rewrote the complete math support, an FPU is no longer required.
  348. -Enhanced the "NODE" command, it displays now all additional information
  349.  it can hold of.
  350. -Removed a stupid bug from the "NODE" command.
  351. -Added the "LABS" command to view the defined labels. Study the doc file for
  352.  details.
  353.  
  354. _____________________________________________________________________________
  355.  
  356. Changes made in 1.57:
  357.  
  358. -Added PAL/NTSC switch.
  359. -Added a check for many command that won't work in a splitted display.
  360.  
  361. _____________________________________________________________________________
  362.  
  363. Changes made in 1.56:
  364.  
  365. -Removed a bug in the printer hardware driver that caused one additional
  366.  character to be printed.
  367. -Added command to eject paper.
  368. -Added Enforcer support for the MC68020 and MC68030 CPUs.
  369. -Added partial MMU support, however no MMU related commands are available.
  370.  Enforcer must be run for this purpose.
  371. -Added IRQ CopyBack mode.
  372. -Fixed several final bugs in the 1.55 release, esp. some MC68060 related,
  373.  although the support isn't complete yet ('60 FPU support is still somewhat
  374.  broken, as the FPU part must be re-written anyways).
  375.  
  376.  
  377. Thomas,
  378.     March 2001
  379.